API changes from Capella 1.2.x/1.3.0 to 1.3.x

Please also refer to Sirius Release Notes.

Major changes

Usage of Representations Descriptors instead of Representations

Representations are defined with two elements:

Since 1.3.x, some information stored in representation have been moved toward descriptors and API has been changed to access to representations towards their descriptors. (see Raw API section below for detailed API changes)

1.2.x Representation
  • Name
  • Description
  • Kind of representation
  • Graphical elements (nodes, edges, layout, active filters)
  • Contextual elements
  • Element of interests
  • Visible in Documentation
Descriptor
  • Name
  • Kind of representation
1.3.x Representation
  • Name
  • Description
  • Kind of representation
  • Graphical elements (nodes, edges, layout, active filters)
Descriptor
  • Name
  • Kind of representation
  • Contextual elements
  • Element of interests
  • Visible in Documentation

Notice that Description is still located on representation, it will be moved in an upcoming Capella release.

AQL instead of Acceleo2

All representation definitions have been migrated to AQL.

Moreover, from Capella 1.3.1, the plug-in org.eclipse.sirius.query.legacy is removed from the list of required bundles for the plug-in org.polarsys.capella.core.sirius.analysis. It means that if your view-point still uses Acceleo2 queries, you might have to explicitly add the plug-in org.eclipse.sirius.query.legacy in the list of required bundles for that view-point. Otherwise, those Acceleo2 queries will not be interpreted and the view-point will not work as expected.

Property tabs identifiers

On Capella 1.3.x, property tabs identifiers provided by Capella have changed to comply with the extension point definition uniqueness requirement.

These identifiers are often used in addons/viewpoints that are providing their own property tabs, like:

<extension point="org.eclipse.ui.views.properties.tabbed.propertyTabs">
  <propertyTabs contributorId="org.eclipse.sirius.diagram.ui">
    <propertyTab
      label="Basic Viewpoint"
      id="BasicViewpoint"
      category="default"
      afterTab="Management">
    </propertyTab>
  </propertyTabs>
</extension>
org.eclipse.ui.views.properties.tabbed.propertyTabs 1.2.x identifiers 1.3.x identifiers
org.polarsys.capella.core.data.capellamodeller.properties
Base
Management
Description
Extensions
Advanced
BaseCapella
ManagementCapella
DescriptionCapella
ExtensionsCapella
AdvancedCapella
org.eclipse.sirius.diagram.ui
Base
Management
Description
Extensions
BaseSiriusDiagram
ManagementSiriusDiagram
DescriptionSiriusDiagram
ExtensionsSiriusDiagram
org.eclipse.sirius.table.ui.EditorID
Base
Management
Description
Extensions
BaseSiriusTable
ManagementSiriusTable
DescriptionSiriusTable
ExtensionsSiriusTable

Extensible Menus have been updated

On Capella 1.2.x, menus were duplicated between several views and between graphical and semantic elements. There was often (but not always) two menu contributions, one working on graphical elements, and another one on semantic elements.

On Capella 1.3.x, menus are no longer duplicated between views and existing menus have been merged into only one menu, available on all elements / views. A menuContribution can decide if it is enabled only on diagrams or semantic elements by contributing the visibleWhen attribute.

Migrated menus

Name Location Old New
Wizards Project explorer org.polarsys.capella.core.wizards org.polarsys.capella.core.wizards
Semantic Browser org.polarsys.capella.core.semantic.browser.wizards?after=additions org.polarsys.capella.core.wizards?after=additions
Diagram org.polarsys.capella.core.sirius.diagram.editor.wizards?after=additions org.polarsys.capella.core.wizards?after=additions
Modeling Accelerators Project explorer capella.project.explorer.menu.accelerator/groupAccelerator org.polarsys.capella.core.accelerators?after=additions
Diagram AcceleratorDiagramCommands/groupAccelerator org.polarsys.capella.core.accelerators?after=additions
Transitions Project explorer capella.project.explorer.menu.transitions.diagram.preferences?after=group.transition org.polarsys.capella.core.transitions?after=additions
Diagram capella.project.explorer.menu.transitions.diagram.preferences?after=group.transition org.polarsys.capella.core.transitions?after=additions
Capella Diagram (unused menu) CapellaDiagramCommands/groupValidation org.eclipse.ui.popup.any?after=group.validation
Diagram (unused menu) CapellaDiagramCommands?after=groupApplicative any other group

On Capella 1.2.x, all menus contributions were contributed to all views. It was leading to have many unwanted menus such as REC/RPL available on unrelevant views.

Menu contributions are (still) organized into several contribution points, among:

Name group.showIn group.sendTo group.semantic group.validation group.rec group.pattern group.transition group.wizard group.allocation group.accelerator

To contribute to a group, you just have to contribute to it through locationUri org.eclipse.ui.popup.any?after=group.validation

On Capella 1.3.x, all contributions (groups) are no longer provided automatically on all views (capella and contributed views). Only group.showIn and group.sendTo are registered across all Capella views.

In a contributed view (from viewpoint or addon), to have all navigation menus, it only requires to add following code in the plugin.xml of your view. (or any other group)

<menuContribution locationURI="popup:org.polarsys.capella.xxxx?after=additions">
  <separator name="group.showIn" visible="true" />
  <separator name="group.sendTo" visible="true" />
</menuContribution>

Property Tester

Some property tester working on semantic elements (org.polarsys.capella.common.data.modellingcore.ModelElement) works now on graphical elements (org.eclipse.gmf.runtime.diagram.ui.editparts.IGraphicalEditPart)

"graphical" property testers are now deprecated and are merged into the semantic one.

Type Old New
IGraphicalEditPart org.polarsys.capella.core.platform.sirius.ui.graphicalActionMode org.polarsys.capella.core.platform.sirius.ui.actionMode
IGraphicalEditPart org.polarsys.capella.core.platform.sirius.ui.graphicalFeatureIsA org.polarsys.capella.core.platform.sirius.ui.featureIsA
IGraphicalEditPart org.polarsys.capella.core.platform.sirius.ui.graphicalLayerOfWithOutDataFlowScenario org.polarsys.capella.core.platform.sirius.ui.layerOfWithOutDataFlowScenario
IGraphicalEditPart org.polarsys.capella.core.platform.sirius.ui.graphicalLayerOf org.polarsys.capella.core.platform.sirius.ui.layerOf

Raw API changes from 1.2.0 to 1.3.0

Changes in org.polarsys.capella.common.flexibility.properties

Changes in org.polarsys.capella.common.flexibility.wizards

Changes in org.polarsys.capella.common.helpers

Changes in org.polarsys.capella.common.platform.sirius.customization

Changes in org.polarsys.capella.common.platform.sirius.ted

Changes in org.polarsys.capella.common.re

Changes in org.polarsys.capella.common.tools.report.appenders.reportlogview

Changes in org.polarsys.capella.common.tools.report

Changes in org.polarsys.capella.common.transition

Changes in org.polarsys.capella.common.ui.massactions.core

Changes in org.polarsys.capella.common.ui.massactions

Changes in org.polarsys.capella.common.ui

Changes in org.polarsys.capella.common.xmisupport

Changes in org.polarsys.capella.common

Changes in org.polarsys.capella.core.af.integration

Changes in org.polarsys.capella.core.commandline.core

Changes in org.polarsys.capella.core.compare

Changes in org.polarsys.capella.core.data.business.queries

Changes in org.polarsys.capella.core.data.core.ui.quickfix

Changes in org.polarsys.capella.core.data.core.validation

Changes in org.polarsys.capella.core.data.fa.ui.wizards

Changes in org.polarsys.capella.core.data.gen.edit.decorators

Changes in org.polarsys.capella.core.data.gen.editor

Changes in org.polarsys.capella.core.data.information.ui.quickfix

Changes in org.polarsys.capella.core.data.la.ui.wizards

Changes in org.polarsys.capella.core.data.menu.contributions

Changes in org.polarsys.capella.core.data.migration

Changes in org.polarsys.capella.core.diagram.helpers

Changes in org.polarsys.capella.core.explorer.activity.ui

Changes in org.polarsys.capella.core.libraries.ui

Changes in org.polarsys.capella.core.libraries

Changes in org.polarsys.capella.core.model.handler

Changes in org.polarsys.capella.core.model.helpers

Changes in org.polarsys.capella.core.model.preferences

Changes in org.polarsys.capella.core.model.skeleton

Changes in org.polarsys.capella.core.platform.eclipse.ui.trace

Changes in org.polarsys.capella.core.platform.sirius.clipboard

Changes in org.polarsys.capella.core.platform.sirius.ui.actions

Changes in org.polarsys.capella.core.platform.sirius.ui.navigator

Changes in org.polarsys.capella.core.platform.sirius.ui.perspective

Changes in org.polarsys.capella.core.platform.sirius.ui.project

Changes in org.polarsys.capella.core.preferences

Changes in org.polarsys.capella.core.projection.commands

Changes in org.polarsys.capella.core.projection.interfaces

Changes in org.polarsys.capella.core.re.project

Changes in org.polarsys.capella.core.re

Changes in org.polarsys.capella.core.refinement.commands

Changes in org.polarsys.capella.core.refinement.scenario

Changes in org.polarsys.capella.core.semantic.queries.sirius

Changes in org.polarsys.capella.core.semantic.queries

Changes in org.polarsys.capella.core.sirius.analysis

Changes in org.polarsys.capella.core.sirius.ui

Changes in org.polarsys.capella.core.tiger

Changes in org.polarsys.capella.core.transition.common.ui

Changes in org.polarsys.capella.core.transition.diagram

Changes in org.polarsys.capella.core.transition.system.topdown

Changes in org.polarsys.capella.core.ui.metric

Changes in org.polarsys.capella.core.ui.properties.richtext

Changes in org.polarsys.capella.core.ui.properties

Changes in org.polarsys.capella.core.ui.reportlog

Changes in org.polarsys.capella.core.ui.search

Changes in org.polarsys.capella.core.ui.toolkit

Changes in org.polarsys.capella.core.validation.ui.ide

Raw API changes from 1.3.0 to 1.3.1

Changes in org.polarsys.capella.common.flexibility.wizards

Changes in org.polarsys.capella.common.re.ui

Changes in org.polarsys.capella.common.re

Changes in org.polarsys.capella.common.tools.report.appenders.console

Changes in org.polarsys.capella.common.tools.report

Changes in org.polarsys.capella.common.transition

Changes in org.polarsys.capella.common.ui.massactions.core

Changes in org.polarsys.capella.common.ui.massactions

Changes in org.polarsys.capella.common.ui.toolkit

Changes in org.polarsys.capella.common.ui

Changes in org.polarsys.capella.common

Changes in org.polarsys.capella.core.data.business.queries

Changes in org.polarsys.capella.core.data.core.ui.quickfix

Changes in org.polarsys.capella.core.data.core.validation

Changes in org.polarsys.capella.core.data.fa.properties

Changes in org.polarsys.capella.core.data.fa.ui.quickfix

Changes in org.polarsys.capella.core.data.fa.validation

Changes in org.polarsys.capella.core.data.gen.edit.decorators

Changes in org.polarsys.capella.core.data.gen.edit

Changes in org.polarsys.capella.core.data.gen

Changes in org.polarsys.capella.core.data.helpers

Changes in org.polarsys.capella.core.data.information.ui.quickfix

Changes in org.polarsys.capella.core.data.information.validation

Changes in org.polarsys.capella.core.data.interaction.ui.quickfix

Changes in org.polarsys.capella.core.data.interaction.validation

Changes in org.polarsys.capella.core.data.migration

Changes in org.polarsys.capella.core.diagram.helpers

Changes in org.polarsys.capella.core.explorer.activity.ui.richtext

Changes in org.polarsys.capella.core.libraries.extendedQueries

Changes in org.polarsys.capella.core.libraries.ui

Changes in org.polarsys.capella.core.model.handler

Changes in org.polarsys.capella.core.model.helpers

Changes in org.polarsys.capella.core.platform.sirius.clipboard

Changes in org.polarsys.capella.core.platform.sirius.ui.navigator

Changes in org.polarsys.capella.core.projection.commands

Changes in org.polarsys.capella.core.re.ui

Changes in org.polarsys.capella.core.semantic.queries

Changes in org.polarsys.capella.core.sirius.analysis

Changes in org.polarsys.capella.core.sirius.ui

Changes in org.polarsys.capella.core.transition.common.ui

Changes in org.polarsys.capella.core.transition.system.topdown

Changes in org.polarsys.capella.core.transition.system

Changes in org.polarsys.capella.core.ui.properties.richtext

Changes in org.polarsys.capella.core.ui.properties

Changes in org.polarsys.capella.core.ui.semantic.browser

Changes in org.polarsys.capella.core.validation.ui.ide

Changes in org.polarsys.capella.core.validation.ui